package org.dromara.admin.service;

import cn.hutool.core.date.DateTime;
import org.dromara.admin.domain.Order;
import org.dromara.admin.domain.vo.OrderVo;
import org.dromara.admin.domain.bo.OrderBo;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.common.mybatis.core.page.PageQuery;

import java.math.BigDecimal;
import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * 订单主（客户ID和供应商ID必须二选一，由应用程序保证）Service接口
 *
 * @author Lion Li
 * @date 2025-10-10
 */
public interface IOrderService {

    /**
     * 查询订单主（客户ID和供应商ID必须二选一，由应用程序保证）
     *
     * @param id 主键
     * @return 订单主（客户ID和供应商ID必须二选一，由应用程序保证）
     */
    OrderVo queryById(Long id);

    /**
     * 分页查询订单主（客户ID和供应商ID必须二选一，由应用程序保证）列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 订单主（客户ID和供应商ID必须二选一，由应用程序保证）分页列表
     */
    TableDataInfo<OrderVo> queryPageList(OrderBo bo, PageQuery pageQuery);

    /**
     * 分页查询当前用户主体的订单列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 订单分页列表
     */
    TableDataInfo<OrderVo> queryPageMyOrderList(OrderBo bo, PageQuery pageQuery);

    /**
     * 查询符合条件的订单主（客户ID和供应商ID必须二选一，由应用程序保证）列表
     *
     * @param bo 查询条件
     * @return 订单主（客户ID和供应商ID必须二选一，由应用程序保证）列表
     */
    List<OrderVo> queryList(OrderBo bo);

    /**
     * 新增订单主（客户ID和供应商ID必须二选一，由应用程序保证）
     *
     * @param bo 订单主（客户ID和供应商ID必须二选一，由应用程序保证）
     * @return 是否新增成功
     */
    Boolean insertByBo(OrderBo bo);

    /**
     * 修改订单主（客户ID和供应商ID必须二选一，由应用程序保证）
     *
     * @param bo 订单主（客户ID和供应商ID必须二选一，由应用程序保证）
     * @return 是否修改成功
     */
    Boolean updateByBo(OrderBo bo);

    /**
     * 添加订单物流信息
     *
     * @param bo 订单物流信息
     * @return 是否添加成功
     */
    Boolean addExpressInfo(OrderBo bo);

    /**
     * 校验并批量删除订单主（客户ID和供应商ID必须二选一，由应用程序保证）信息
     *
     * @param ids     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 首页面板获取订单统计信息
     *
     * @param companyId 公司ID
     * @param start     开始时间
     * @param end       结束时间
     */
    Map<String, Object> getOrderStats(Long companyId, DateTime start, DateTime end);

    /**
     * 根据主体公司ID获取最近10条订单列表
     *
     * @param companyId 公司ID
     */
    List<Order> queryRecent10OrderListByCompanyId(Long companyId);

    /**
     * 获取最新订单编号
     * @param userId 用户ID
     * @return
     */
    String getOrderNo(Long userId);

    /**
     * 作废订单
     * @param orderId 订单ID
     * @return
     */
    Boolean cancel(Long orderId);

    /**
     * 计算符合条件订单 actualAmount 总和
     */
    BigDecimal getTotalActualAmount(OrderBo bo);
}
